QTVRSetMouseOverHotSpotProc2

QTVRSetMouseOverHotSpotProc

You can use the QTVRSetMouseOverHotSpotProc function to install or remove a mouse over hot spot procedure.

EXTERN_API_C( OSErr )
QTVRSetMouseOverHotSpotProc (
                    QTVRInstance qtvr,
                     QTVRMouseOverHotSpotUPP mouseOverHotSpotProc,
                     SInt32         refCon,
                     UInt32         flags);

qtvr

An instance of a QuickTime VR movie.

mouseOverHotSpotProc

A universal procedure pointer for a mouse over hot spot procedure. See "Mouse Over Hot Spot Procedure" for information about mouse over hot spot procedures.

refCon

A reference constant. This value is passed to the specified mouse over hot spot procedure.

flags

Unused. Set this parameter to 0.

function result

A result code.

DESCRIPTION

The QTVRSetMouseOverHotSpotProc function installs the routine specified by the mouseOverHotSpotProc parameter as a mouse over hot spot procedure for the QuickTime VR movie specified by the qtvr parameter. Subsequent user actions (such as moving the cursor over an enabled hot spot in that movie) cause the callback routine to be executed. The reference constant specified by the refCon parameter is passed unchanged to your callback routine.

To remove a previously installed callback routine, set mouseOverHotSpotProc to nil .

Your mouse over hot spot procedure is called only for enabled hot spots.